home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / b_link10.zip / B-LINK.EXE / B-LINK / B-LINK.DOC < prev   
Text File  |  1994-02-06  |  12KB  |  315 lines
  1.  
  2. B-LINK - BASIC LINK for the NEWTON
  3. ----------------------------------
  4.  
  5. 1)   FROM THE LAWYERS:
  6.  
  7.      B-LINK is "FREEWARE" and as such may be freely used and
  8. distributed. Absolutely no fee is to be charged for using or
  9. providing this program/package. Please distribute the B-LINK.EXE
  10. archive unaltered.
  11.  
  12.      Neither the author, his spouse, relatives, heirs, friends, or
  13. casual acquaintances assume any responsibility or liability from
  14. the use of B-LINK. Always backup your NEWTON before using B-LINK.
  15. It's always better to be safe than sorry!
  16.  
  17.  
  18. 2)   INTRODUCTION/BACKGROUND:
  19.  
  20.      B-LINK was created for two purposes:
  21.  
  22.         1) Allow users to upload information to their NEWTON from
  23.            any operating system: DOS, OS/2 (DOS box), Windows (DOS
  24.            box) - using a reasonably friendly GUI.
  25.  
  26.         2) Demonstrate to developers the protocol necessary for
  27.            them to create even better apps that will allow users to
  28.            upload information to their NEWTON (eg: an import
  29.            function).
  30.  
  31.      B-LINK can be used by your secretary during the day to add
  32.      names, appointments, etc. to the database. When you get back
  33.      to the office the B-LINK database can be uploaded to the
  34.      NEWTON. A procedure that I find works well is:
  35.  
  36.         -  when you leave the office have your secretary use B-LINK
  37.            to capture new appointments, contact names, etc.
  38.  
  39.         -  when someone calls (eg: John Sculley) have your
  40.            secretary add "CALL SCULLEY" to the notepad database.
  41.  
  42.         -  if the secretary doesn't have John's number it can be
  43.            added to the B-LINK business card database.
  44.  
  45.         -  when you arrive back at the office download the B-LINK
  46.            database to the NEWTON.
  47.  
  48.         -  you can then go through the new notepad items (eg: CALL
  49.            SCULLEY) and use the intelligent assistant to help you 
  50.            catch up.
  51.  
  52.      B-LINK started out as a quick weekend "hack" written in BASIC
  53.      from various skeleton programs that were available. Most
  54.      notably I borrowed some code from a program called "TDB.BAS"
  55.      which was written as a telephone database program and uploaded
  56.      to CIS as freeware.
  57.  
  58.      BTW, BASIC celebrates it's 30th birthday this year.
  59.      
  60.      All of the protocol information required for writing this was
  61.      available on the Internet. However it took some digging around
  62.      to find the information I needed. Using FTPMAIL from CIS is
  63.      quite valuable!
  64.  
  65.      When I showed B-LINK to other NEWTON users they encouraged me
  66.      to continue developing it. The resulting code is not a pretty
  67.      sight <G> - but it does the job!
  68.  
  69.      Thanks to Mr. Robert E. Johnson (oh yeah - the 3rd) the
  70.      creator of "PDALINK" for the inspiration for writing B-LINK.
  71.      I hope that others will use B-LINK and create other more
  72.      useful shareware apps and that they will SHARE their source
  73.      with others.
  74.  
  75.  
  76. 3)   ENVIRONMENTS:
  77.  
  78.      B-LINK was written in BASIC so that it could be used on a
  79.      rather ordinary DOS machine. It will also work in a DOS box
  80.      under Windows. I have not yet figured out how to get it to
  81.      work properly under an OS/2 DOS box (I am using special COM
  82.      drivers which may be interfering), but it should be possible. 
  83.  
  84.      It has been setup to default to COM1: at 9600 baud. The COM
  85.      port can be selected from the main menu. The baud rate and
  86.      other COM parameters can be changed in the program if
  87.      necessary.
  88.  
  89.  
  90. 4)   HARDWARE:
  91.  
  92.      To use B-LINK to transfer data to the NEWTON from a PC you
  93.      will need a "NULL MODEM" cable. This cable is not the same as
  94.      the serial cable used to connect the PC to a modem. A null
  95.      modem cable (or adapter) is available at Radio Shack for about
  96.      $10.00. To create your own, just crisscross lines 2 and 3 on
  97.      the serial cable.
  98.  
  99.  
  100.  
  101. 5)   USAGE:
  102.  
  103.      B-LINK is pretty straight forward to use. All the functions
  104.      are available by selecting a menu option, a sub-menu option,
  105.      then using the database screens that follow. There is some
  106.      online help available to guide you.
  107.  
  108.      To run B-LINK simply run the "B-LINK.BAT" which will start the
  109.      QBASIC program needed to run it.
  110.  
  111.      If you get really stuck (eg: if your COM port gets stuck while
  112.      transmitting) you'll need to hit BREAK to exit the program. If
  113.      you land in the QBASIC program just exit from there and start
  114.      over again.
  115.  
  116.  
  117. 6)   SCREENS:
  118.  
  119.      The MAIN menu:
  120.  
  121.  
  122.           File         Newton       Port                  
  123.         ┌─────────┐                                       
  124.         │ Load    │▓▓                                     
  125.         │ Save    │▓▓                                     
  126.         │ Import  │▓▓                                     
  127.         │ Summary │▓▓                                     
  128.         │ Exit    │▓▓                                     
  129.         └─────────┘▓▓                                     
  130.            ▓▓▓▓▓▓▓▓▓▓                                     
  131.  
  132.  
  133.      Load: Restore a previously saved B-LINK database file (B-
  134.            LINK.DB).
  135.  
  136.      Save: Save the current database records to the current B-LINK
  137.            directory.
  138.  
  139.      Import:  This is for someone else to develop!
  140.  
  141.      Summary: Gives you a count of the number of current database
  142.               records that are in memory. It also tells you what
  143.               COM port is currently selected.
  144.  
  145.      Exit: Go back to DOS.
  146.  
  147.  
  148.      The NEWTON menu:
  149.  
  150.  
  151.           File         Newton       Port                  
  152.                  ┌────────────────┐                   
  153.                  │ Business Card  │▓▓                 
  154.                  │ Appointment    │▓▓                 
  155.                  │ Notepad        │▓▓                 
  156.                  │ Anniversary    │▓▓                 
  157.                  │ Daily Note     │▓▓                 
  158.                  │ Daily Alarm    │▓▓                 
  159.                  └────────────────┘▓▓                 
  160.                     ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓                 
  161.                                                   
  162.  
  163.      When you select an option from the NEWTON menu you will go to
  164.      the database view/entry screen. From this screen you can
  165.      always exit back to the main menu by pressing PF10. 
  166.  
  167.      You will only be able to work with the database records for
  168.      the NEWTON sub-menu application you have selected (except for
  169.      find and print which works on all database records). When you
  170.      try to browse forward/backward it will only browse the
  171.      database records for the current NEWTON sub-menu application
  172.      selected. If no records exist for the selected application you
  173.      will automatically go into the ADD RECORD mode. 
  174.  
  175.      You can abort adding or editing a record by pressing the <ESC>
  176.      key before completing the add/edit.
  177.  
  178.  
  179.      Sample sub-menu screen:
  180.  
  181.                 Single Appointment Data Entry Screen           
  182.  
  183.     ╔════[ 2 / 2 ]══════════════════════════════════════════════╗
  184.     ║                                                           ║ 
  185.     ║              Year: 1994                                   ║
  186.     ║                                                           ║ 
  187.     ║ Start Date (MMDD): 0401    Start Time (HHMM): 1800        ║ 
  188.     ║                              End Time (HHMM): 2000        ║ 
  189.     ║                                                           ║ 
  190.     ║                            Alarm Time (HHMM): 0000        ║ 
  191.     ║                                                           ║ 
  192.     ║       Description: Meeting with John Sculley              ║ 
  193.     ║                                                           ║ 
  194.     ║                                                           ║ 
  195.     ║                                                           ║ 
  196.     ║                                                           ║ 
  197.     ╚═══════════════════════════════════════════════════════════╝ 
  198.  
  199.     1Help 2Add 3Delete 4Edit 5Find 6Prev 7Next 8Send 9Print 10Exit  
  200.  
  201.         The [ 2 / 2 ] represents: the left number is the record
  202.         number currently being worked on, the right number is the
  203.         total number of records in the database.
  204.  
  205.         The data fields are subject to basic editing restrictions:
  206.  
  207.            Year: must be numeric between 1904-2999
  208.  
  209.            Month: must be numeric between 1-12
  210.  
  211.            Day: must be numeric between 1-31
  212.  
  213.            Time: must be numeric between 0000-2359 (yes, it's 24hr)
  214.  
  215.            Description: can be alphanumeric and must be entered
  216.  
  217.         NOTE: there is no intra-data editing done. Eg: B-LINK will
  218.         allow you to setup an appointment that ends before it
  219.         starts. Also, you can add an appointment for Feb. 31st. 
  220.         However the NEWTON will not like it if you do that!
  221.  
  222.         The PF key help line defines how to select various database
  223.         functions. PF1 selects a help screen.
  224.  
  225.      The NEWTON sub-menu applications:
  226.  
  227.      Business Card:
  228.  
  229.         Allows you to add a name card to your NEWTON's unfiled
  230.         names folder. Note: Only the persons LAST NAME is used! So
  231.         I enter the person's name in LAST, FIRST format in that
  232.         field.
  233.  
  234.      Appointment:
  235.  
  236.         Allows you to add a single appointment to your calendar.
  237.         NOTE: the alarm function does not appear to be picked up by
  238.         the NEWTON so you can just enter "0000" in that field.
  239.  
  240.      Notepad:
  241.  
  242.         Allows you to add a short 5 line notepad page.
  243.  
  244.  
  245.      Anniversary:
  246.  
  247.         Allows you to add a day note that will automatically be set
  248.         with an annual frequency.
  249.  
  250.  
  251.      Daily Note:
  252.  
  253.         Allows you to add a day note that will automatically be set
  254.         to appear for the duration specified.
  255.  
  256.      Daily Alarm:
  257.  
  258.         Allows you to set the time of day that an automatically
  259.         scheduled appointment (30 minute duration) called "Daily
  260.         Alarm" will be defined. NOTE: this repeating event has no
  261.         end date - so if you want it to stop it you'll have to go
  262.         to the date you want to end it at and delete it from the
  263.         NEWTON's calendar.
  264.  
  265.  
  266.      The PORT Menu:
  267.  
  268.  
  269.           File         Newton       Port                  
  270.                                    ┌───────┐               
  271.                                    │ COM1  │▓▓             
  272.                                    │ COM2  │▓▓             
  273.                                    └───────┘▓▓             
  274.                                       ▓▓▓▓▓▓▓▓             
  275.                                                  
  276.  
  277.      Select the COM port that you want to use. NOTE: the program
  278.      automatically defaults to COM1 if you do not select a port.
  279.  
  280.      You can check which PORT is selected by picking the SUMMARY
  281.      sub-menu option from the FILE menu option.
  282.  
  283.  
  284.  
  285. 7)   THE AUTHOR:
  286.  
  287.      I was one of the first proud owners of a NEWTON in Toronto. As
  288.      a System's Development Project Leader at Canada's second
  289.      largest bank (CIBC) I use the NEWTON daily to help organize my
  290.      business and personal life.
  291.  
  292.      I am also the organizer of a group of fellow users of the
  293.      NEWTON in Toronto - called "GNUT" (Group of NEWTON Users in
  294.      Toronto) pronounced NEWT. The group meets regularly every
  295.      couple months. The meetings are announced and minutes are
  296.      distributed via the COMPUSERVE NEWTON forum.
  297.  
  298.      To contact me please send EMAIL to:
  299.  
  300.      John Marman
  301.      CIS: 70410,1257
  302.      Internet: 70410.1257@compuserve.com
  303.  
  304.  
  305.      Please let me know what you think of B-LINK. If you create new
  306.      applications based on B-LINK please let me know.
  307.  
  308.      Live long and thanks for all the fish!
  309.  
  310.  
  311.      John.
  312.  
  313.  
  314.                     *         *         *         *
  315.